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(57) ABSTRACT 

Systems and methods that enable a source code file con- 
taining in-line database access statements to be compiled 
into object code for an application without the use of a 
pre -compiler are disclosed. In one aspect of the system, the 
source code contains delimiters that enclose an attribute 
section comprising in-line database access statements. The 
compiler of the system communicates the attribute section to 
an attribute provider, which translates the attribute section 
into statements that can be processed by the compiler. A 
further aspect of the system is that the attribute provider is 
a software component. The software component can be a 
COM (Component Object Model) component. A still further 
aspect of the system is that the attribute provider can 
communicate with a database management system in order 
to assist in validating the attributes against the tables and 
columns of the database. 
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IN-LINE DATABASE ACCESS STATEMENTS There arc significant disadvantages in both of the above- 

WITHOUT A PRE-COMPDLER mentioned systems. In the API based system, SQL state- 
ments that are provided as parameters must typically be 
enclosed within quotation marks to avoid the native lan- 

FIELD OF THE INVENTION 5 guage compiler from attempting to parse the SQL statement 

This invention relates generally to computer program- as a native Programming language statement. If the state- 

ming language compilers, and more particularly to embed- ment itself ^ <* uotes > s P ecial characters are often required 

ding database access statements in the source code submit- to P revcnt ^ compiler from becoming confused by the 

ted to such compilers, multiple sets of quotes (one or more in the statement, and the 

10 statement enclosing quotes). Furthermore, SQL statements 

COPYRIGHT NOHCE/PERMISSION can often be quite long and require multiple lines in the 

- ,. , f 4 . . , 4 . A source code. Often the developer must either insert special 

A portion of the disclosure of this patent document end of ]iQe cbaracters at ^ end of each line nt (he 

contains material which is subject to copyright protection. fler from terminati me expressioil prematurely, or 

The copyright owner has no object.on to he facsimile „ , to ^ ^ statement oQ & ^ , e , , ke ^ 

reproduction by anyone of the patent document or the patent renders ^ statemenl ^ tQ read 

disclosure as it appears in the Patent and Trademark Office _ , . 

patent file or records, but otherwise reserves all copyright Systems employing the embedded language method also 

rights whatsoever. The following notice applies to the soft- ^significant disadvantages. In addition to the problems 

ware and data as described below and in the drawing hereto: „ noted above > ^ pre-compiler adds complexity to the devel- 

Copyright ©2000, Microsoft Corporation, All Rights 20 opment process because the developer must remember to 

Reserved invoke the pre-compiler, or must modify scripts to cause the 

pre-compiler to be invoked. In addition, developers must 

BACKGROUND OF THE INVENTION manage two sets of files, the pre-compiled source code and 

w ^ 4 . . , 4 , . the translated source code. 
Many software applications require a database to persis- 05 

tently store data used by the application. As a result, soft- Therefore, there is a need in the art for a system that 

ware developers need to design software that interfaces with provides a way for developers to embed database language 

database software. In general, database management soft- ^ mt0 na f ,ve programming language source code flies 

ware provides one or both of two types of interfaces, an API wlthoxit firing the use of a pre-compiler. 

(Application Program Interface), or an embedded language 30 SUMMARY OF THE INVENTION 
style interface. 

In the case where the database software interface is The above-mentioned shortcomings, disadvantages and 

through an API, the database management software provides problems are addressed by the present invention, which will 

a set of methods (also known as functions) that are called be understood by reading and studying the following speci- 

from within the application program software. The methods 35 fication. 

typically cause the database management system to read, The present invention includes systems and methods that 
write, and update rows in the database. In addition methods enable a source code file containing in-line database access 
are provided that bind columns to variables, and that provide statements to be compiled into object code for an application 
session and transaction support. The methods typically take without the use of a pre-compiler. In one aspect of the 
parameters that control or modify the behavior of the 40 system, the source code contains delimiters that enclose an 
method, and receive output from the method. It is often the attribute section comprising in-line database access state- 
case that a SQL (Structured Query Language) statement will ments. The compiler of the system communicates the 
be one of the parameters to a method or function. attribute section to an attribute provider, which translates the 
In the case of an embedded language interface, the attribute section into statements that can be processed by the 
database management system vendor defines a database 45 compiler. 

access language in a grammar that is specific to the vendor. A further aspect of the system is that the attribute provider 

Typically the grammar will support SQL statements. In jg a software component. The software component can be a 

order to develop software that accesses a database, a soft- COM (Component Object Model) component, 

ware developer embeds statements in the database access A ^ &rthcr t of the tem ^ ^ ^ attributc 

language into the source code for the software. Thus, the 50 idef cafl communicate ^ a database management 

database access language statements are interspersed with tem m order to assist in validating the attributes against 

native programming language statements, such as C/C++ ^ ^ and co]umns of ^ database 
statements. The developer must then run what is known as 

a pre-compiler on the source code. Tne pre-compiler is a The present invention describes systems, clients, servers, 

parser application provided by the database management 55 m ;j hods > and computer-readable media of varying scope. In 

system vendor that is able to parse the embedded statements addlt ™ to u tb r f 4 *?? 8 md advan *gf of the present inven- 

in the database access grammar. Toe developer submits the UoD de f r u lbed m mis ™ ar * ***** a ° d advan " 

source code file to the pre-compiler. Tne pre-compiler of mc mvc f° n becomc W"™ 1 by reference to 

ignores statements in the native source code and only *e drawings and by reading the detailed description that 

processes those statements in the database access language. 60 I0U0WS - 

The database language statements are translated into native BRIEF DESCRIPTION OF THE DRAWINGS 
programming language statements. The original native pro- 
gramming language statements and the statements translated FIG. 1 shows a diagram of the hardware and operating 
from the database programming language are output to a environment in conjunction with which embodiments of the 
processed source code file. The processed source code file is 65 invention may be practiced; 

then submitted to a native programming language compiler, FIG. 2 is a diagram illustrating a system-level overview of 

which produces an object file. exemplary embodiments of a source code compiler system; 
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FIG. 3 is a flow diagram illustrating methods of process- plurality of processing units, commonly referred to as a 

ing in-line database access statements according to exem- parallel processing environment. The computer 20 may be a 

plary embodiments of the invention. conventional computer, a distributed computer, or any other 

type of computer; the invention is not so limited. 

DETAILED DESCRIPTION OF THE s The system bus 23 may be any of several types of bus 

INVENTION structures including a memory bus or memory controller, a 

In the following detailed description of exemplary P« jheral bus^nd a bcal bus using any of a variety of bus 

.u u.v Lv.uu«iij 6 v. wiivu y . / architectures. The system memory may also be referred to as 

embodiments of the invention reference js made to the ^ ^ m ; and iQC i ude s read only memory (rqm) 

accompanying drawings which form a part hereof, and in ^ ^ random access mem (RAM) 25. A basic input/ 

which is shown by way of illustration specific exemplary » containing the basic routines that 

embodiments in which the invention may be practiced. ^ between elements within lhe 

These embodiments are described m sufficient detail to t6f 2 „ such as durf s ^ stof6d in RQM u 

enable those skilled in the art to practice the invention and ^ ef 20 indudes a hafd ^ drfve 2? fof 

itistobeunderstoodthatomerembodmientsmaybeuhlized readi £ om and ^ , o a hard dkk nQt sh a 

and that logical mechanical, electrical and other changes " ^ ^ ^ ^ for Kadi ftom or ^ t£) a 

may be made without deputing from me spirit or scope of removabk tic disk29 ^ ^cal diskdrive 30 for 

the present invention. The following detailed description is, ^ {tQm or ^ , o a removable Ucal disk 31 ^ 

therefore, not to be taken in a hmihng sense, and the scope ^ a CQ RQM Qr othef tical media 

of the present invention is denned only by the appended , , ,. , , . i_ ,. , . . . 

claims 20 *h e nar ° <"•'* " nyt * '» magnetic disk drive 28, and 

optical disk drive 30 are connected to the system bus 23 by 

The detailed description is divided into five sections. In a nald ^ drfv6 intcrface 32> a magaetic driv6 mt er- 

the first section, the hardware and the operating environment face 33, and an optical disk drive interface 34, respectively, 

in conjunction with which embodiments of the invention ^ drfves ^ tneir computer-readable media' 

may be practiced are described. In the second section, a ide nonvo latile storage of computer-readable 

system level overview of the invention is presented. In the ^^0^ data structures, program modules and other 

third section, methods of an exemplary embodiment of the data for ^ computer 2 o. It should be appreciated by those 

invention are provided. In the fourth section, a particular skmed m ^ an mat any type of computer-readable media 

COM (Microsoft's Component Object Model) object reposi- which can s(ore data that jg accessible by a colter, such 

tory implementation of the invention is described. Finally, in 3Q as magnetic cassettes, flash memory cards, digital video 

the fifth section, a conclusion of the detailed description is disks> BcTDoMi cartr idge S , random access memories 

provided. (RAMs), read only memories (ROMs), and the like, may be 

Hardware and Operating Environment used in the exemplary operating environment. 

A number of program modules may be stored on the hard 

FIG. 1 is a diagram of the hardware and operating 35 disk, magnetic disk 29, optical disk 31, ROM 24, or RAM 

environment in conjunction with which embodiments of the 25, including an operating system 35, one or more applica- 

invention may be practiced. The description of FIG. 1 is tio D programs 36, other program modules 37, and program 

intended to provide a brief, general description of suitable data 38. A user may enter commands and information into 

computer hardware and a suitable computing environment in the personal computer 20 through input devices such as a 

conjunction with which the invention may be implemented. 40 keyboard 40 and pointing device 42. Other input devices 

Although not required, the invention is described in the ( no t shown) may include a microphone, joystick, game pad, 

general context of computer-executable instructions, such as satellite dish, scanner, or the like. These and other input 

program modules, being executed by a computer, such as a devices are often connected to the processing unit 21 

personal computer. Generally, program modules include through a serial port interface 46 that is coupled to the 

routines, programs, objects, components, data structures, 45 system bus, but may be connected by other interfaces, such 

etc., that perform particular tasks or implement particular as a parallel port, game port, or a universal serial bus (USB), 

abstract data types. A monitor 47 or other type of display device is also 

Moreover, those skilled in the art will appreciate that the connected to the system bus 23 via an interface, such as a 

invention may be practiced with other computer system video adapter 48. In addition to the monitor, computers 

configurations, including hand-held devices, multiprocessor 50 typically include other peripheral output devices (not 

systems, microprocessor-based or programmable consumer shown), such as speakers and printers, 

electronics, network PCS, minicomputers, mainframe The computer 20 may operate in a networked environ- 

computers, and the like. The invention may also be practiced ment using logical connections to one or more remote 

in distributed computing environments where tasks are computers, such as a remote computer 49. These logical 

performed by remote processing devices that are linked 55 connections are achieved by a communication device 

through a communications network. In a distributed com- coupled to or a part of the computer 20; the invention is not 

puting environment, program modules may be located in limited to a particular type of communications device. The 

both local and remote memory storage devices. remote computer 49 may be another computer, a server, a 

The exemplary hardware and operating environment of router, a network PC, a client, a peer device or other 

FIG. 1 for implementing the invention includes a general 60 common network node, and typically includes many or all of 

purpose computing device in the form of a computer 20, the elements described above relative to the computer 20, 

including a processing unit 21, a system memory 22, and a although only a memory storage device 50 has been illus- 

system bus 23 that operatively couples various system trated in FIG. 1. The logical connections depicted in FIG. 1 

components including the system memory to the processing include a local-area network (LAN) 51 and a wide-area 

unit 21. There may be only one or there may be more than 65 network (WAN) 52. Such networking environments are 

one processing unit 21, such that the processor of computer commonplace in offices, enterprise-wide computer 

20 comprises a single central-processing unit (CPU), or a networks, intranets and the Internet, 
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When used in a LAN-networking environment, the com- one embodiment of Ihe invention, a "[" delimiter character 

puter 20 is connected to the local network 51 through a is used to introduce an attribute section and a matching 

network interface or adapter 53, which is one type of is used to conclude the attribute section. However, the 

communications device. When used in a WAN-networking invention is not limited to any particular attribute delimiter 

environment, the computer 20 typically includes a modem s character. In general, the delimiter characters can be any 

54, a type of communications device, or any other type of character or string of characters that can be unambiguously 

communications device for establishing communications interpreted as the beginning and end of an attribute section 

over the wide area network 52, such as the Internet. The 204. 

modem 54, which may be internal or external, is connected [ n further embodiments of the invention, the attribute 
to the system bus 23 via the serial port interface 46. In a io sections are introduced by one or more delimiter characters 
networked environment, program modules depicted relative an( j terminated by one or more predetermined language 
to the personal computer 20, or portions thereof, may be tokens. The predetermined language tokens can be an end- 
stored in the remote memory storage device. It is appreciated of-line token, an end of page token, or it can be any token 
that the network connections shown are exemplary and other that is inconsistent with an attribute token (i.e. a token in the 
means of and communications devices for establishing a 15 primary language). As those of skill in the art will 
communications link between the computers may be used. appreciate, many mechanisms for determining the start and 
The hardware and operating environment in conjunction end of a section of tokens embedded within primary lan- 
with which embodiments of the invention may be practiced guage statements are possible and within the scope of the 
has been described. The computer in conjunction with which invention. 

embodiments of the invention may be practiced may be a 20 Attribute sections have what is known in the art as scope, 

conventional computer, a distributed computer, or any other The scope of an attribute section 204 depends on its position 

type of computer; the invention is not so limited. Such a m source code file 202 relative to other entities in source 

computer typically includes one or more processing units as co d e file 202. For example, an attribute section that imme- 

its processor, and a computer-readable medium such as a diately precedes a function or method declaration will be in 

memory. The computer may also include a communications 25 SCQpe for the duration of the function. An attribute that 

device such as a network adapter or a modem, so that it is appears within a function will also be in scope for the 

able to communicatively couple other computers. duration of the function. An attribute section that appears 

. before a class definition will be in scope for all of the 
System Level Overview members of the class. An attribute that appears before a 
Asystem level overview of the operation of an exemplary 30 variable, property or parameter will have the same scope as 
embodiment of the invention is described by reference to the variable, property, or parameter. 
FIG. 2. The concepts of the invention are described as As compiler 206 reads source code file 202, it parses the 
operating in a multiprocessing, multithreaded virtual statements according to the grammar of the primary pro- 
memory operating environment on a computer, such as ^ gramrning language. The parsed statements are translated 
computer 20 in FIG. 1. In this environment compiler 206 into object code instructions that are intended to be executed 
receives as input a source code file 202, and translates the by a particular type of processor. In addition, as compiler 
source code into an object code file 208 that contains 206 reads source code file 202, it will parse an attribute 
instructions that can be executed by a computer, such as delimiter character. Upon seeing such a character, the corn- 
computer 20. 4Q piler submits the attribute section 204 to an attribute pro- 
Source code file 202 can comprise computer source vider 210. In one embodiment of the invention, attribute 
written in any of a number of programming languages provider 210 is a software module that is designed to parse 
known in the art. Source code file 202 contains statements a secondary programming language, such as SQL. Attribute 
that conform to a first programming language, which will be provider 210 translates the statements and/or expressions in 
referred to as the primary language. Examples of such 45 the secondary programming language into statements and 
languages includes C/C++, Visual Basic, Java, Ada, Pascal, expressions in the primary language, and provides the trans- 
and Smalltalk etc. The invention is not limited to any lation to compiler 206, effectively inserting the translation 
particular programming language. Generally, source code into the source 202. Compiler 206 then generates computer- 
file 202 will be one of many source code files associated executable instructions that implement the logic expressed 
with a software application. Further, source code file 202 can 50 by the statements for insertion into object code file 208. 
contain statements that are designed to read or write data to in some embodiments of the invention, attribute provider 
database 214. 210 is what is known in the art as a component. It is 
In addition to primary language statements, source code desirable that attribute provider 210 be a component because 
file 202 contains one or more attribute sections 204 that it provides a mechanism for easily replacing components 
comprise statements that conform to a second programming 55 and for extending the system to handle multiple types of 
language system. In one embodiment of the invention, the attributes. For example, new attribute provider components 
second programming language comprises the Structured can be provided that fix defects (i.e. "bugs") in the compo- 
Query Language, or SQL. SQL, as is known in the art, nent it replaces. Alternatively, new components can be 
provides a mechanism for interacting with a database 214. provided that add functionality, or that handle new types of 
Attribute sections 204 can be of varying lengths. For 60 attributes. In one embodiment of the invention attribute 
example, an attribute section 204 can be a single word that provider 210 is a COM (Component Object Model) corn- 
provides additional information regarding a particular vari- ponent. In an alternative embodiment of the invention, 
able. Alternatively, attribute section 204 can be a multiple attribute provider 210 can be a Java bean component. The 
fine section comprising a complex SQL query that specifies invention is not limited to any particular component object 
data to be read from, or written to database 214. $5 model. 

In some embodiments of the invention, attribute sections Attribute provider 210 can access other entities in order to 

204 are enclosed within one or more delimiter characters. In aid in the parsing, translation and validation of attribute 
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invention, attribute provider 210 can access a type library expressions in the input source code file. Block 304 obtains 
212 defining type information for other software modules the next available expression to be parsed, unless no further 
accessible to attribute provider 210. In general, a type library unprocessed expressions or statement remain in the source 
contains a programming language independent description 5 code file. Next, a check is made to determine if the expres- 
of the interfaces and methods exposed by the objects sion is delimited by an attribute delimiter character (block 
described by the type library. In some embodiments of the 306). In one embodiment of the invention, the character 
invention, these objects are COM objects, however the begins an attribute section, and the"]" concludes an attribute 
invention is not limited to any particular type of object. In section. In alternative embodiments, the attribute section is 
an exemplary embodiment, the type library 212 can provide 10 introduced by a delimiter string, and terminated by a pre- 
type definitions for data access components that attribute determined token such as an end-of-line character, an end- 
provider 210 can use to generate code as part of its trans- of-page character, or a token that is inconsistent with the 
lation process. syntax of the secondary language. If the expression is not 

In addition, in one embodiment, attribute provider 210 within an attribute delimiter, then the compiler proceeds to 

can access a database 214 to assist in the translation process. 15 P arse tne expression as a primary language expression 

The ability to access a database 214 is desirable, because it (° lock 308 )- The parsed expression is then used to generate 

provides a mechanism for attribute provider 210 to provide ob j ecl code that is output to an object code file (block 310). 

validation and error checking for code in attribute sections The object code may be object code for a particular proces- 

204. For example, if an attribute section 204 contains an sor m & operating system environment, or it can be an 

expression that binds a variable to a database column, 20 intermediate language representation of object code that will 

attribute provider 210 can examine database 214 to deter- later De translated into object code for a particular processor 

mine that the column specified in the attribute section exists. and operating system environment. After generating the 

Similarly, if the attribute section 204 contains references to ob j ect code > the system executing the method returns to 

databases or tables, attribute provider 210 can examine block 304 to get the next expression, 

database 214 to make sure the referenced database or table 25 However, if the check at block 306 determines that the 

actually exists. If the database or table does not exist, expression is within a delimiter character, the expression is 

attribute provider 210 can generate an error message to be passed to an appropriate attribute provider (block 312). 

displayed by compiler 206. Attribute provider then parses the expression as a secondary 

In some embodiments of the invention, compiler 206 can language expression (block 314). For example, the second- 
select from a plurality of attribute providers 210. The 30 ary language can be a SQL language expression. The sec- 
selection of a particular attribute provider can be determined ondary language expression is then translated into a primary 
by a type associated with the attribute. For example, the language expression (block 316). The primary language 
attribute can be in a tertiary language distinct from the expression that is generated will depend on the contents and 
primary and secondary languages. The compiler (or parser placement of the secondary language expression within the 
within the compiler) can then submit the attribute section to 35 primary language statements. For example, if the attribute 
the appropriate attribute provider based on the attribute type. section precedes a class definition, then the generated pri- 

Further details regarding the operation of the above- marv language code will modify the class. If the attribute 

described components are provided in the following sec- section is within a class member function, the generated 

^ ous primary language code will modify the function. 

, 40 After the primary language code is generated, it is 

Methods of an Exemplary Embodiment of the returDed tQ the inserting the generated primary 

Invention language into the parse stream as if the compiler had read the 

In the previous section, a system level overview of the generated statements from the input source code file (block 

operation of an exemplary embodiment of the invention was 318). 

described. In this section, the particular methods of various 45 The particular methods for providing compilation of a 

embodiments of the invention performed by an operating secondary programming language embedded in-line within 

environment executing an exemplary embodiment are statements in a primary programming language performed 

described by reference to a flowchart shown in FIG. 3. The by an operating environment to support various exemplary 

methods to be performed by the operating environment embodiments of the invention have been described. The 

constitute computer programs made up of computer- 50 methods have been shown by reference to a series of 

executable instructions. Describing the methods by refer- flowcharts including all the steps from 302 until 318. 

ence to a flowchart enables one skilled in the art to develop w . r _„ . ~ , . 

such programs including such instructions to carry out the Microsoft Visual Studio Implementation 

methods on suitable computers (the processor of the com- In this section of the detailed description, a particular 

puter executing the instructions from computer-readable 55 exemplary implementation of the invention is described that 

media). The methods illustrated in FIG. 3 are inclusive of the is implemented in Microsoft Visual Studio. In addition, a 

acts required to be taken by an operating environment particular implementation is described in which the attribute 

executing an exemplary embodiment of the invention. provider is a component conforming to the Microsoft Com- 

In FIG. 3, a method according to one embodiment of the ponent Object Model (COM), 

invention for processing secondary language statements that 60 Microsoft \faual Studio is a software development envi- 

are embedded in-line with primary language statements is ronment that incorporates various programming language 

shown. The method begins when a program, such as com- compilers, a source code editor, and a symbolic debugger, 

piler 206, receives as input a source code file for compilation Microsoft's Visual Basic, Visual C++, and Visual J++ pro- 

(block 302). As noted above, the source code file will gramming language compilers are all supported within the 

contain expressions in primary programming language such 65 Visual Studio environment. 

as C/C++, Java, Ada, etc. The invention is not limited to any In one exemplary embodiment, the compiler is the Visual 

particular primary programming language. C++ compiler. In this embodiment, the Visual C++ compiler 



04/22/2004, EAST Version: 1.4.1 



US 6,629313 Bl 

9 10 

reads source code flies that have statements and expressions ordinal column position or a column name within a rowset. 

that conform to the C++ programming language. In addition, It is desirable to provide both means for accessing a column 

the source code can contain attribute sections delimited by by its ordinal position or its column name because doing so 

the "[" and characters. When the "Visual C++ compiler provide flexibility to a software developer. In one embodi- 

encounters an attribute section, it passes the attribute section s ment of the invention, column names are resolved at 

to an attribute provider, which parses the statements and runtime, when the db_command attribute is opened, 

expressions within the attribute section. However, the invention is not so limited, and the column 

In this exemplary embodiment, the attribute provider name can be resolved at compile time. The general syntax 

supports various attributes. Included in the supported for a db_column attribute is: 

attributes are db source, db_accessor, db_command, 10 [db_column(ordinal=#[, colname=COLUMNNAME] [, 

db_column, and db_param attributes. The attributes can dbtype=DBLONG] [, statusfield=STATUSFIELD] [, 

modify parameters, variables, class members, and the class length=LENGTHFIELD])] 

itself depending on the placement of the attribute. In the where: 

exemplary embodiment, the modifications to the class allow ordinal is the column position within the rowset; 

the class to perform as an OLE DB data class. A discussion - 15 colname is the column name defined by the rowset; 

of the various attributes and examples of the code generated dbtype is the database type of the column; 

by the attribute provider when the attributes are encountered statusfield is a variable which will contain the status of 

in the C++ source code follows. the field; 

db_source length is a variable which will contain the length of the 

The db_source attribute identifies connection informa- 20 field; 

tion necessary to open an OLE DB connection. This attribute The following excerpt provides an example C++ source 

can be applied to a class, or implemented within a class. Id code segment with in-line db_column attributes: 
addition, the db_source attribute is used to add OLE DB 
datasource client properties to a class or within a function. 

If used within a function, the code will be injected within the 25 — ^__ _________ __ 

function scope. Both the method level and class level [awolZn ^ 1 DBTYPEJ4)] J^f^ [gc , 

attributes infer a OLE DB CDataSource and a CSession [dblcoW (3)] tchar Lc% [30]; 

object. In the case of the class level, the inferred CSession 

becomes a member of the class, while at the method level it 

becomes a local. The general syntax of the db__source 30 In response to the above example, the attribute provider 

attribute is as follows: generates the following code: 

[db„source(name-MyDbl, connecting-"")] COLUMN JNTRY_TYPE(1, DBTYPE_J4, nValue); 

whcre . COLUMN„ENTRY(2, szName); 

name is the name assigned to a particular datasource or _ f COLUMN_ENTRY(3, szCity); 

database- * n one embodiment of the invention, the generated code 

connectstring is an OLE DB compliant connection includes the C++ macros COLUMN__ENTRY_TYPE and 

string containing parameters to specify connection COLUMN_ENTRY defined by the ATL OLE DB template 

behavior. classes. In alternative embodiments of the invention, native 

The following excerpts provide two example C++ source 4Q programming language code such as C++ can be generated 

code segments with in-line db_column attributes. The first instead of the macros, 

example illustrates the db_source attribute appearing imme- db_param 

diately before a class definition. The db_param attribute is a member attribute that iden- 
tifies a C++ member variable and associates it with an input 

,, niT% w PnA n AT * or output parameter associated with an OLE DB command, 

db source("Provider=MSDASQL;Data 45 „ * v . , . r n 

v The general syntax is as follows: 

Source=OLE„DB„NWind_Jet") [db„param(ordinal.l,paramty P e-"DB„PARAMIO_ 

] INPUT")] 

class CMyDbsource where: 

{ 50 ordinal is the ordinal position of the parameter within 

}; the command; 

In this example, the code is generated that adds a method paramtype specifies whether the parameter is an input 

called OpenDataSource, which contains the necessary com- parameter, an output parameter, or both input and 

mands to open the datasource for the connection string that output. 

is passed as a parameter to the db_source command. 55 The following excerpt provides an example C++ source 

The second example illustrates the db__source attribute code with in-line db_param attributes: 

appearing outside of any class definitions. In this example, [db_param(l, DB_PARAMIOJNPUT)] long nlnputl; 

the "MyDb2" parameter specifies the name of the local In response to the above example, the attribute provider 

variable that will be created. generates the following code: 

[db_source("MyDb2", "Provide r=MS DAS QL; Data 60 SET_PARAM_TYPE(DB_PARAMIO_INPUT) 

Source=OLE_DB__NWind_Jet")]; COLUMN_ENTRY(l, nlnputl) The generated code 

In this example the generated code comprises the code includes the C++ macros SET_JPARAM_TYPE and 

necessary to open up the data source within the function COLUMN__ENTRY defined by the ATL consumer 

where the attribute is placed. template library. 

db_coIumn 65 db_accessor 

The db_column attribute is a member attribute, which The db_accessor attribute modifies the underlying OLE 

identifies a C++ member variable and associates it with an DB accessor for subsequent db_column and db_param 
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attributes within the same class or fraction. This attribute is 
useable at a class member level and is used to group 
db_coluran attributes that participate in OLE DB [Accessor 
based binding. It is used in conjunction with either the 
db_table or db_command attributes. In effect this attribute 
infers the use of the OLE DB Consumer Template MACRO 
set of BEGIN ^ACCESSOR . . . END^ACCESSOR. When 
one or more db_accessor attributes are specified, the code 
generated by the attribute provider will generate a rowset 
and bind it to the corresponding accessor maps. The accessor 
number is automatically calculated, starting with 0. If a 
db_accessor is not specified, accessor 0 will automatically 
be generated, and all bindings will be mapped to this 
accessor block. The general syntax for the db_accessor 
attribute is as follows: 
[db__accessor(auto=true)] 
where: 

Auto identifies whether or not data in this accessor will 
be automatically fetched when moving from row to 
row. 

The following excerpt provides an example C++ source 
code with in-line db_accessor attributes: 



[db_acces8or] 

[db_param (1, DB_PARAMIO_INPUT)] 
[db_column (1, DBTVPE_I4)) 
[db_column (2)] 

[db_column (4)] 
[db_acccssor (false)] 
[db_column (3)] 



long nlnputl; 
long nValue; 
TCHAR szNamc 
[80]; 

TCHAR szCity [30J 



BYTE 



bytPictuic 
[4096]; 



long 


nlnputl; 


long 


ii Value; 


TCHAR 


szName [80]; 


TCHAR 


szCity [301 


BYTE 


bytPicture [4096]; 
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the generated code related to attributes other than the 
db_accessor attribute. These attributes and macros have 
been described above. 
db_command 

The db_command attribute causes code to be generated 
that issues a command to a database management system, 
which will optionally return a rowset. The general syntax for 
using the attribute according to an embodiment of the 
invention is as follows: 
[db_command( 

< db_command="SELECT*FROM AUTHORS"> 

<, name-MyName> 

<, source_name=Dbl> 

<, hresult-myHR> 

<, bindingsa"([bindto] foo, bar)([in] nID)"> 



20 



25 



30 



In response to the above example, the attribute provider 
generates the following code: 



BEGIN_ACCESSOR_JvlAP (MyClassName, 2) 
BEGIN_ACCESSOR(0, true) 

COLUMN_ENTRY_TYPE(l, DBTYPE_I4, 
nValue); 

COLUMN__ENTRY(2, szName); 
COLUMN_ENTRY(4, szCity); 
END^ACCESSOR( ) 

BEGIN_^ACCESSOR(l, false) // not an auto accessor 
COLUMN_ENTRY(3, bytPicture) 

END_ACCESSOR( ) 
END_ACCESSOR_MAP( ) 
BEGIN_PARAMETER_MAP(MyClassName) 

SET„PAR AM_JTYPE(D B __PARAMIO__INPUT) 

COLUMN_ENTRY(l, nlnputl) 
END_PARAMETER_MAP( ) 

In the exemplary code generated above, the "MyClass- 
Name" string comprises the name of the class that the 
attribute is within. 

As shown above, the generated code includes macros 
defined by OLE DB classes. These macros related to the 
db_accessor attribute include the BEGIN_J\CCESSOR_ 
MAP, BEGINLACCESSOR, END__ACCESSOR, and 
END_ACCESSOR_JVlAP. Other macros are included in 



35 



40 



45 



50 
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60 
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{ 



»>) 



. . »>) 
. . »>) 



([bindtype]szVarl<, szVar2<, nVar3<, . 
any OLEDB Command 
([bindtype]szVarl<, szVar2<, nVar3<, . 
continuation of OLEDB Command 
([bindtype]szVarl<, szVar2<, nVar3<, . 

}] 

where: 

db__command is the command text which will be 
passed into the OLE DB provider by the generated 
code. This can be either entered in the db_command 
parameter, or in braces after the end of the attribute. 

Name is the handle for working with the rowset. 

source__rjame is the Database or Session upon which 
this command will execute. 

Hresult identifies the variable which will receive the 
HRESULT of this database command. If the variable 
does not exist, it will be automatically injected (i.e. 
generated) by the attribute. 

Bindings allow a user to separate the binding param- 
eters from the OLE DB command. If this parameter 
is specified, then the attribute provider will not parse 
the db_command parameter for [bindtype]. This 
usage provides for an OLE DB provider syntax that 
looks exactly like the attribute provider binding 
syntax, without requiring the developer to rewrite 
their OLE DB commands. To disable parsing 
db_command, without binding parameters, simply 
include Bindings^'". 

([bindtype]szVarl<, szVar2<,nVar3<, ...»>) is a bind 
parameter block. If the user specifies Bindings, the 
attribute provider will parse the associated value, 
otherwise, the attribute provider parses the 
db_command string for '(\ followed by [bindtype] 
in square brackets, followed by one or more previ- 
ously declared C++ member variables, followed by 
a closing parenthesis *)'. All text between the paren- 
thesis is stripped from the resulting Command, and 
these parameters are used to construct column and 
parameter bindings for the command. 
( marks the start of the data binding block, 
[bindtype] is one of the following case insensitive strings: 

[bindto] This variable binds to one of the columns in 
the rowset. 

[db_column] Same as [bindto]. 

[in] Bind to one or more input parameters. 

[out] Bind to one or more output parameters. 

[in,out] Bind to one or more Input/Output parameter. 
szVarX resolves to a member variable within the current 

scope. 
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) marks the end of the data binding block 

Id the exemplary embodiment, [bindtype] syntax and the 
Bindings parameter are not valid when using db_command 
at the class level. 

When Name is specified, the attribute provider generates 
a named class for traversing the rowset, or executing the 
action query multiple times. If Name is not specified, it is not 
possible to return more than one row of results to the user. 

When the attribute provider encounters one or more of 
[in], [out], [in/out] expressions, the attribute provider builds 
a parameter map. When the attribute provider encounters 
one or more of [db__column] or [bindto] parameters, the 
attribute provider generates a rowset and an accessor map to 
service these bound variables. The accessor map created is 
similar to that create by the db_accessor attribute. 

It should be noted that the db_command attribute can be 
used to execute commands, including SQL statements, that 
do not return a result set. 

The following excerpts provide examples C++ source 
code with in-line db__command attributes. The first example 
illustrates a db„command for which the attribute provider 
will generate code that will retrieve a rowset: 

H RESULT hr; 

TCHAR szFname[80]; 

TCHAR szLname[80]; 

long nZip; 

[db_command (name -Too") 
{ 

SELECT FNAME, LNAME 
([bindto] szFname, szLname) 
FROM AUTHORS 
WHERE ZIPCODE=?([in]nZip) 

}]; 

nZip =98053; // Set the parameter 
hr=Foo.Open(ds); 
while(Foo.MoveNext( )==S_OK) 
{ 

ATLTRACE("\nFirst: %s Last: %s\n", szFname, 
szLname); 

}; 

Foo.Close( ); 

The rowset can then be manipulated and accessed by the 
OLE DB Open, MoveNext, Close and related ATL OLE DB 
consumer template classes functions. The db_command 
takes a name parameter, which will cause the attribute 
provider to generate a variable with the indicated name. In 
the example above, this name is "Foo". Thus, when the next 
row is desired, the user calls Foo.MoveNext( ) 

The example C++ excerpt below contains attributes that 
will cause the attribute provider to generate code to auto- 
matically open the rowset, fetch the first row into the 
specified bind variables, then close the rowset: 

H RESULT hr; 

TCHAR szFname[80]; 

TCHAR szLname[80]; 

long nZip=98053; 

[db_command 

{ 

SELECT FNAME([bindto]szFname), LNAME 

([b indto jszLname) 
FROM AUTHORS 
WHERE ZIPCODE=?([in]nZip) 

}]; 
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%$ Last: 



%s\n", szFname, 



ATLTRACE("\nFirst: 
szLname); 

Like the example above, this exemplary C++ excerpt will 
cause the attribute provider to generate code to automati- 
cally open the rowset, fetch the first row into the specified 
bind variables, and then close the rowset. In this example, 
the bindings for result sets and input parameters are speci- 
fied as parameters to the db_command attribute. 

HRESULT hr; 

TCHAR szFname[80]; 

TCHAR szLname[80];. 

long nZip-98053; 

[db_command (bindings="([bindto]szFname } szLname); 
([in]nZip)") 

{ 

SELECT FNAME, LNAME 
FROM AUTHORS 



20 



WHERE ZIPCODE=? 



65 



}]; 

ATLTRACE("\n First: %s Last: %s\n", szFname, 
szLname); 

[n the example below, the db__command attribute is 
passed parameters specifying OLE DB accessors that define 
the input and output bindings. The accessors can be estab- 
lished by a previously invoked db_accessor attribute. The 
attribute provider will generate code that retrieves a first row 
from the rowset, and places the results into the specified 
bound variables. 

[db_command (UseConnection=DBl, AccessorClasse 
"MyAccessor") 

{ 

SELECT FNAME, LNAME 
FROM AUTHORS 
WHERE STATE =? 

}]; 

db_table 

The db_table attribute is very similar to db_command. 
Typically, it is used as a class level attribute. When invoked, 
the db_table attribute infers a class derived from CTable 
class of the OLE DB Consumer Templates. The syntax of the 
db_table attribute according to an embodiment of the inven- 
tion is as follows: 
[db_table( 
db_table="Table" 
[, name=MyName] 

[, source name=MySource] 

[, hresult=MyHR] 

)] 

where: 

db_table is the command text which is passed into 
OLE DB. 

name is the handle for working with the rowset. 
source__name is the Database or Session upon which 

this table will be opened, 
hresult identifies the variable which will receive the 
HRESULT of this database table open. If the variable 
does not exist, it will be automatically injected (i.e. 
generated) by the attribute. 
This section of the detailed description has described an 
embodiment of the invention and particular attributes. As 
will be appreciated by those skilled in the art, the invention 
is not limited to attributes having the names specified in the 
exemplary embodiments, or the parameters shown. The 
attribute names and parameters in the exemplary embodi- 
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attribute, however, the invention is not limited to such erating statements in the first programming language 

functionality. includes generating OLE DB class entities. 

11. A computerized system comprising: 

Conclusion c - • • j 

5 a computer comprising a processor, a memory, and a 

Systems and methods for compiling source code with computer-readable medium operatively coupled 

embedded attributes have been described. Although specific together; 

embodiments have been illustrated and described herein, it an operating environment executing in the processor from 

will be appreciated by those of ordinary skill in the art that the computer-readable medium; 

any arrangement which is calculated to achieve the same ™ aQ attribute provider operative to parse expressions in a 

purpose may be substituted for the specific embodiments secondary programming language and to translate the 

shown. This application is intended to cover any adaptations parsed expressions into expressions in a primary pro- 

or variations of the present invention. gramming language; and 

For example, those of ordinary skill within the art will a compiler running within the operating environment, said 
appreciate that while the embedded attribute command compiler operative to receive a file containing state- 
language has been described in terms of SQL compatible ments m a p rimary programming language and 
language, that other means of querying objects can be attributes in the secondary programming language, said 
readily substituted. In addition, the embedded language can compiler communicating the attributes to the first 
be OQL (Object Query Language). ^ attribute provider and receiving translated expressions 

The terminology used in this application is meant to in the primary programming language, 
include all of these environments. Therefore, it is manifestly 12. The computerized system of claim 11, further corn- 
intended that this invention be limited only by the following prising a second attribute provider; and wherein the file 
claims and equivalents thereof. contains attributes in a tertiary programming language, the 

We claim: 25 compiler communicating the attributes in the tertiary pro- 

1. A computerized method for compiling source code, the gramming language to the second attribute provider and 
method comprising: receiving translated expressions in the primary program- 
receiving by a compiler a file having statements in a first ming language. 

programming language, and attributes in a second 13. The computerized system of claim 11, wherein the 

programming language; 30 first attribute provider is a first software component, 

parsing the file into a set of expressions, said expressions 14. The computerized system of claim 13, wherein the 

comprising tokens, said tokens including an opening first software component conforms to the Component Object 

attribute delimiter string and an attribute terminator; Model (COM). 

and 15. The computerized system of claim 12, wherein the 

if the expressions are not enclosed within the opening 35 second attribute provider is a second software component, 

attribute delimiter string and the attribute terminator 16 ^ computerized system of claim 11, wherein the 

then translating the expressions according to the first Penary programming language is the C++ programming 

programming language into an object code, otherwise language. 

passing the expressions to an attribute provider, said 17 - ^ computerized system of claim 11, wherein the 

attribute provider operative to perform the acts of: 40 secondary programming language includes statements in the 

parsing the expressions according to the second pro- Structured Query Language (SQL). 

gramming language; ^ & computerized system of claim 11, wherein the 

generating statements 'in the first programming lan- attribute provider is further operative to generate entities 

guage from the parsed expressions; hom a set of classes defined b ? a version of OLE DB * 
returning the generated statements to the compiler for 45 19 - ^ computerized system of claim 11, further corn- 
translation into object code. P risin g a database management system commumcably 

2. The computerized method of claim 1, wherein the first coupled to the attribute provider. 

programming language is the C++ programming language. 20 - The computerized system of claim 19, wherein the 

3. The computerized method of claim 1, wherein the database management system is a relational database man- 
second programming language includes statements in the 50 a g emen t system. 

Structured Query Language (SQL). 21 ^ computerized system of claim 19, wherein the 

4. The computerized method of claim 1, wherein the database management system is an object oriented database 
attribute terminator comprises an end-of-line character. management system. 

5. The computerized method of claim 1, wherein the 22 - ^ computerized system of claim 19, wherein the 
attribute terminator comprises a closing delimiter string. 55 attribute Provider is further operative to validate the expres- 

6. The computerized method of claim 5, wherein the slons m ^ secondary programming language agamst the 
opening delimiter string comprises an opening square brace database system. 

("[") character and the closing delimiter string comprises a 23 - A computer-readable medium having computer- 
closing square brace character ("]"). executable instructions for performing a method for com- 

7. The computerized method of claim 1, further compris- 60 P mn S ssmm «> de > the method comprising: 

ing validating the expressions passed to the attribute pro- receiving by a compiler a file having statements in a first 

vider against a database. programming language, and attributes in a second 

8. The computerized method of claim 1, wherein the programming language; 

attribute provider is a software component. parsing the file into a set of expressions, said expressions 

9. The computerized method of claim 8, wherein the 65 comprising tokens, said tokens including an opening 
software component conforms to the Component Object attribute delimiter string and an attribute terminator; 
Model (COM). and 
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if the expressions are not enclosed within the opening 27. Tne computer-readable medium of claim 23, wherein 

attribute delimiter string and the attribute terminator the attribute terminator comprises a closing delimiter string, 

then translating the expressions according to the first 28. The computer-readable medium of claim 27, wherein 

programming language into an object code, otherwise me ope ning delimiter string comprises an opening square 

passing the expressions to an attribute provider, said 5 brace (T) characler and me attribute terminator comprises 

attribute provider operative to perform the acts of: a cJosing e bface cnaracter m 

parsing the expressions according to the second pro- ^ ^ computer _ reada51e medium of claim ^ wherein 

gramming anguage, . the method further comprises validating the expressions 

generating statements in the first programming lan- , . r . , . * u r 

to ? . _j . passed to the attribute provider against a database. 

guage from the parsed expressions; 10 r r * . 

returning the generated statements to the compiler for u 30 * ™ e computer-readable medium of claim 23, wherein 

translation into object code. the attnbute P r0Vlder 1S a saftwarc com P OQent - 

24. The computer-readable medium of claim 23, wherein 31 ^ computer-readable medium of claim 30, wherein 
the first programming language is the C++ programming tne software component conforms to the Component Object 
language. 15 Model (COM). 

25. The computer-readable medium of claim 23, wherein 32. The computer-readable medium of claim 23, wherein 
the second programming language includes statements in the generating statements in the first programming language 
Structured Query Language (SQL). includes generating OLE DB class entities. 

26. The computer-readable medium of claim 23, wherein 

the attribute terminator comprises an end-of-line character, ***** 
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